home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Controls / Visual Basic Controls.iso / vbcontrol / vdvsview / readme.txt next >
Encoding:
Text File  |  1998-04-23  |  19.9 KB  |  496 lines
  1. ========================================================================
  2. VSVIEW 3.0.21
  3. ========================================================================
  4.  
  5. ================================================
  6. NEW EVENTS, PROPERTIES AND METHODS     22 Apr 98
  7. ================================================
  8. Change in build 15 dated 16 February 1998:
  9.  
  10.     Property PaperSize handles sizes 42 to 68.
  11.     See the Documentation Changes paragraph below.
  12.  
  13.     Properties TwipsPerPixelX and TwipsPerPixelY changed from type Integer to type 
  14.     Single to increase usability of the two properties in calculations.
  15.  
  16. Change in build 14 dated 9 February 1998:
  17.  
  18.       Added File Date/Time info to archives:
  19.  
  20.         ArchiveInfo(f, arcFileDate, i)
  21.  
  22.       returns a Date.
  23.  
  24.  
  25. ================================================
  26. WARNINGS AND CAVEATS (CUMULATIVE)      22 Apr 98
  27. ================================================
  28. To use VSVIIEW3 under Windows NT4, you have to have Service Pack 2 or later installed.
  29. Correct function of VSVIEW3 under Windows NT4 without SP2 or later is not guaranteed.
  30.  
  31. VSVIEW3 depends of MFC42.DLL.  (Version 2 used MFC40.DLL.)
  32.  
  33. ================================================
  34. DOCUMENTATION CHANGES                  22 Apr 98
  35. ================================================
  36.  
  37.  
  38. ================================================
  39. CORRECTED PROBLEMS                     22 Apr 98
  40. ================================================
  41. vsPrinter
  42.    16 bit version prints paragraph incorrectly
  43.    16 bit version often, but not always, mishandles the header font
  44.    AddTable with Append True prints black background (NT4 only)
  45.    Colors are shifted (made darker)
  46.    Embedded tab causes wrapping and overlay
  47.    PaperSize does not accept valid settings > 255
  48.    PrintDialog changes ingored under NT4
  49.    RenderControl fails with a Windows error
  50.    Setting orientation before StartDoc crashes the app (NT4 only)
  51.    VBX wraps text even with format character ~ (tilde)
  52.  
  53. vsViewPort
  54.    16 bit version causes GPF on vertical scroll bar click
  55.    Line controls not scrolled
  56.    ViewPort gets scrollbar only if its BorderStyle is None
  57.  
  58.  
  59. ================================================
  60. WAIVERS (CUMULATIVE)                   22 Apr 98
  61. ================================================
  62. VSVIEW3 16 bits (Vsview3-.OCX) does not have the Appearance property.
  63. Waiver:  This property is not available to 16 bit OCX controls.
  64.  
  65. Many RTF commands are not working
  66. Waiver:  This is a Riched32.dll problem.  VideoSoft is expecting Microsoft's corrections.
  67.  
  68. InForm CustomFrame may set a wrong height of an OCX object
  69. Waiver:  This is a Windows limitation for certain types of OCXes, such as VSOCX 5.
  70.  
  71. InForm's OnTop property True ignored for MDI children
  72. Waiver:  This is a Windows limitation: Windows does not honor the flag for MDI children.
  73.  
  74.  
  75. ================================================
  76. KNOWN PROBLEMS (CUMULATIVE)            22 Apr 98
  77. ================================================
  78. vsPrinter does not print PictureBox drawings
  79. Cause:          VB bug.
  80. Circumvention:  Instead of printing the drawing directly, assign it to an image
  81.                 control and print image control's Picture instead.
  82.  
  83. Unassigned shortcut keys may cause errors in property pages.
  84. Cause:          This is a Mfc42.dll problem.
  85. Circumvention:  None.
  86.  
  87. Custom form with InForm with CustomFrame changes both dimensions when resized in only one direction.
  88. Cause:          This is a Windows API problem.
  89. Circumvention:  Not available.
  90.  
  91. InForm's CustomFrame = True disables click-type controls (listbox, combo, filesystem controls).
  92. Cause:          This is a Windows API problem.
  93. Circumvention:  Place controls onto another container (picture, elastic).
  94.  
  95.  
  96. ================================================
  97. LIMITATIONS (CUMULATIVE)               22 Apr 98
  98. ================================================
  99. vsPrinter does not print graphics embedded in RTF.
  100. This will be corrected in the next version.
  101.  
  102. ================================================
  103. End of entries for build 21            22 Apr 98
  104. ================================================
  105.  
  106. Build 3.0.19 *************************************************
  107. ================================================
  108. DOCUMENTATION CHANGES                  10 Mar 98
  109. ================================================
  110. ------------------------------------------------
  111. Manual, page 40, AddTable Method.
  112.  
  113. '----------------------------------------------------------------
  114. ' original code (has a problem)
  115. '----------------------------------------------------------------
  116. For j = 1 To 3  'Number of tables.
  117.     strTable = ""
  118.     .AddTable strLayout, strTH, strTable, vbRed, vbGreen, False     '<<< 1
  119.     For i = 1 To 60 'Number of lines.
  120.         strTable = Str$(i) & "|" & Str$(i) & "|" & Str$(i)
  121.         .AddTable strLayout, strTH, strTable, vbRed, vbGreen, True  '<<< 2
  122.     Next i
  123.     .Paragraph = ""
  124. Next j
  125.  
  126. The problem here is this: line <1> tries to print an empty table, consisting only
  127. of a header. Normally, this will succeed and the code will work as expected.
  128.  
  129. However, if the header is at the bottom of the page, vsPrinter detects that there
  130. is no room for it plus a body row, so it goes to the page-skipping code. There, since
  131. there is no body, the operation is cancelled.
  132.  
  133. There are two alternatives of better handling:
  134.  
  135. '----------------------------------------------------------------
  136. ' alternative 1
  137. '----------------------------------------------------------------
  138. For j = 1 To 3  'Number of tables.
  139.     strTable = ""
  140.     '
  141.     ' ** this line has been commented out (don't print tables without body)
  142.     '.AddTable strLayout, strTH, strTable, vbRed, vbGreen, False    '<<< 1
  143.     For i = 1 To 60 'Number of lines.
  144.         strTable = Str$(i) & "|" & Str$(i) & "|" & Str$(i)
  145.         '
  146.         ' ** this line has been changed (append if not first line)
  147.         .AddTable strLayout, strTH, strTable, vbRed, vbGreen, i > 1 '<<< 2
  148.     Next i
  149.     .Paragraph = ""
  150. Next j
  151.                 
  152. '----------------------------------------------------------------
  153. ' alternative 2
  154. '----------------------------------------------------------------
  155. For j = 1 To 3  'Number of tables.
  156.     strTable = ""
  157.     '
  158.     ' ** this line has been commented out (don't print tables without body)
  159.     '.AddTable strLayout, strTH, strTable, vbRed, vbGreen, False    '<<< 1
  160.     For i = 1 To 60 'Number of lines.
  161.         strTable = strTable & Str$(i) & "|" & Str$(i) & "|" & Str$(i) & ";"
  162.     Next i
  163.     '
  164.     ' ** this line has been moved (print the whole table at once)
  165.     .AddTable strLayout, strTH, strTable, vbRed, vbGreen, False     '<<< 2
  166.     .Paragraph = ""
  167. Next j
  168.  
  169. This code works faster -- the entire table is printed at once.  Typically, this is
  170. the method you would prefer to use. The only advantage of version 1 is that it allows
  171. for alternating background colors etc. If you do not need them, alternative 2 is better.
  172.  
  173.  
  174. ------------------------------------------------
  175. Manual, page 162, FAQ on printing MSChart.
  176.  
  177. Clipboard.GetData in the sample code misses data type.  Correct code follows:
  178.  
  179.     Clipboard.Clear
  180.     MSChart1.EditCopy
  181.     vsPrinter1.StartDoc
  182.     vsPrinter1.X1 = 3000
  183.     vsPrinter1.Y1 = 3000
  184.     vsPrinter1.X2 = 3000 + MSChart1.Width
  185.     vsPrinter1.Y2 = 3000 + MSChart1.Height
  186.     vsPrinter1.Picture = Clipboard.GetData(vbCFMetafile) ' type was missing
  187.     vsPrinter1.EndDoc
  188.  
  189.  
  190. ================================================
  191. CORRECTED PROBLEMS                     10 Mar 98
  192. ================================================
  193. vsPrinter
  194.    Action 13 & 14 do not work under NT
  195.    AddTable does not print table headers
  196.    Font size changes after changing printer
  197.    Margins initially cut off in preview pane
  198.    Panning broken after orientation change
  199.    PrintDialog does not set the printer
  200.    Printer dialog does not change the default printer
  201.    Table borders deplete system resources
  202.    TextBox displays wrong PenStyle
  203.  
  204. ================================================
  205. WAIVERS                                10 Mar 98
  206. ================================================
  207. VSVIEW3 16 bits (Vsview3-.OCX) does not have the Appearance property.
  208. Waiver:  This property is not available to 16 bit OCX controls.
  209.  
  210. Many RTF commands are not working
  211. Waiver:  This is a Riched32.dll problem.  VideoSoft is expecting Microsoft's corrections.
  212.  
  213.  
  214. ================================================
  215. KNOWN PROBLEMS                         10 Mar 98
  216. ================================================
  217. Unassigned shortcut keys may cause errors in property pages.
  218. Cause:          This is a Mfc42.dll problem.
  219. Circumvention:  None.
  220.  
  221. Custom form with InForm with CustomFrame changes both dimensions when resized in only one direction.
  222. Cause:          This is a Windows API problem.
  223. Circumvention:  Not available.
  224.  
  225. InForm's CustomFrame = True disables click-type controls (listbox, combo, filesystem controls).
  226. Cause:          This is a Windows API problem.
  227. Circumvention:  Place controls onto another container (picture, elastic).
  228.  
  229.  
  230. ================================================
  231. LIMITATIONS                            10 Mar 98
  232. ================================================
  233. vsPrinter does not print graphics embedded in RTF.
  234. This will be corrected in one of the subsequent builds.
  235.  
  236. ================================================
  237. End of entries for build 19            10 Mar 98
  238. ================================================
  239.  
  240. Build 3.0.15 *************************************************
  241. ================================================
  242. DOCUMENTATION CHANGES                  16 Feb 98
  243. ================================================
  244. ------------------------------------------------
  245. Manual, page 77-78, PaperSize Property.
  246.  
  247. Valid settings for the PaperSizes are between 1 and 68, inclusive.
  248.  
  249. Values beyond 41 denote:
  250.  
  251.   DMPAPER_ISO_B4              42  /* B4 (ISO) 250 x 353 mm              */
  252.   DMPAPER_JAPANESE_POSTCARD   43  /* Japanese Postcard 100 x 148 mm     */
  253.   DMPAPER_9X11                44  /* 9 x 11 in                          */
  254.   DMPAPER_10X11               45  /* 10 x 11 in                         */
  255.   DMPAPER_15X11               46  /* 15 x 11 in                         */
  256.   DMPAPER_ENV_INVITE          47  /* Envelope Invite 220 x 220 mm       */
  257.   DMPAPER_RESERVED_48         48  /* RESERVED--DO NOT USE               */
  258.   DMPAPER_RESERVED_49         49  /* RESERVED--DO NOT USE               */
  259.   DMPAPER_LETTER_EXTRA          50  /* Letter Extra 9 \275 x 12 in        */
  260.   DMPAPER_LEGAL_EXTRA           51  /* Legal Extra 9 \275 x 15 in         */
  261.   DMPAPER_TABLOID_EXTRA          52  /* Tabloid Extra 11.69 x 18 in        */
  262.   DMPAPER_A4_EXTRA               53  /* A4 Extra 9.27 x 12.69 in           */
  263.   DMPAPER_LETTER_TRANSVERSE   54  /* Letter Transverse 8 \275 x 11 in   */
  264.   DMPAPER_A4_TRANSVERSE       55  /* A4 Transverse 210 x 297 mm         */
  265.   DMPAPER_LETTER_EXTRA_TRANSVERSE 56 /* Letter Extra Transverse 9\275 x 12 in */
  266.   DMPAPER_A_PLUS              57  /* SuperA/SuperA/A4 227 x 356 mm      */
  267.   DMPAPER_B_PLUS              58  /* SuperB/SuperB/A3 305 x 487 mm      */
  268.   DMPAPER_LETTER_PLUS         59  /* Letter Plus 8.5 x 12.69 in         */
  269.   DMPAPER_A4_PLUS             60  /* A4 Plus 210 x 330 mm               */
  270.   DMPAPER_A5_TRANSVERSE       61  /* A5 Transverse 148 x 210 mm         */
  271.   DMPAPER_B5_TRANSVERSE       62  /* B5 (JIS) Transverse 182 x 257 mm   */
  272.   DMPAPER_A3_EXTRA            63  /* A3 Extra 322 x 445 mm              */
  273.   DMPAPER_A5_EXTRA            64  /* A5 Extra 174 x 235 mm              */
  274.   DMPAPER_B5_EXTRA            65  /* B5 (ISO) Extra 201 x 276 mm        */
  275.   DMPAPER_A2                  66  /* A2 420 x 594 mm                    */
  276.   DMPAPER_A3_TRANSVERSE       67  /* A3 Transverse 297 x 420 mm         */
  277.   DMPAPER_A3_EXTRA_TRANSVERSE 68  /* A3 Extra Transverse 322 x 445 mm   */
  278.  
  279. Values outside range 1 to 68 and 256 (user defined) are INVALID.
  280.  
  281. ================================================
  282. CORRECTED PROBLEMS                     16 Feb 98
  283. ================================================
  284. vsPrinter
  285.    Alignment different in running text and in text box 
  286.    ArchiveInfo does not fire the Error event
  287.    PageSizes range (as described above)
  288.  
  289. ================================================
  290. End of entries for build 15            16 Feb 98
  291. ================================================
  292.  
  293. Build 3.0.14 *************************************************
  294. ================================================
  295. NEW EVENTS, PROPERTIES AND METHODS      9 Feb 98
  296. ================================================
  297. Added File Date/Time info to archives:
  298.  
  299.      ArchiveInfo(f, arcFileDate, i)
  300.  
  301.   returns a Date
  302.  
  303.  
  304. ================================================
  305. DOCUMENTATION CHANGES                   9 Feb 98
  306. ================================================
  307. ------------------------------------------------
  308. Manual, page 126-127, DrawEllipse, DrawLine, and DrawRectangle properties of vsDraw.
  309.  
  310. The book and the Help file incorrectly states that X1, X2, Y1, and Y2 values are
  311. single precision.
  312.  
  313. These values, as correctly indicated by their ampersand suffixes, are type Long.
  314.  
  315.  
  316. ================================================
  317. CORRECTED PROBLEMS                      9 Feb 98
  318. ================================================
  319. vsPrinter
  320.    Archive method filenames should be checked
  321.    ArchiveInfo does not check for invalid file names
  322.    ArchiveInfo does not check for invalid files
  323.    ArchiveInfo has no range checking
  324.    Japanese RTF does not work
  325.    LoadDoc doesn't fire error with invalid file
  326.    RenderControl does not print the exact VSFLEX
  327.    Setting PaperHeight/Width fires two errors
  328.    TableBorder settings do the same thing
  329.    TextAlign = Justified does not account for IndentFirst
  330.    TextBox auto height calculation is wrong
  331.    TwipsPerPixelX/Y return a wrong value
  332.    UAE when invalid path set to Archive
  333.    UAE when MarginBottom is set to a very large value (> 10 inches)
  334.    Unreadable characters in Abort Dialog
  335.  
  336. ================================================
  337. End of entries for build 14             9 Feb 98
  338. ================================================
  339.  
  340. ================================================
  341. CORRECTED PROBLEMS                     13 Jan 98
  342. ================================================
  343. vsPrinter
  344.   Quality of printing of graphics improved
  345.  
  346. ViewPort
  347.   16-bit control does not always show scrollbars
  348.  
  349. ================================================
  350. End of entries for this build          13 Jan 98
  351. ================================================
  352.  
  353. ================================================
  354. NEW EVENTS, PROPERTIES AND METHODS     30 Oct 97
  355. ================================================
  356. None.
  357.  
  358. ================================================
  359. DOCUMENTATION CHANGES                  30 Oct 97
  360. ================================================
  361. ------------------------------------------------
  362. Manual, page 44-46, CalcParagraph, CalcPicture, CalcTable, CalcText, and CalcTextRTF Properties,
  363. Manual, page 65-66, Measure and Measuring Properties:
  364.  
  365. All calculating and measuring properties work only between StartDoc and EndDoc.
  366.  
  367. -----------------------------------------------
  368. Manual, page 70, NewLine Event:
  369.  
  370. NewLine event is not fired when printing RTF text.
  371.  
  372. ------------------------------------------------
  373. Manual, page 75-76, PaperBin Property:
  374.  
  375. To accommodate the newest types of printers, PaperBin allows setting in the 255-258 range.
  376.  
  377. ------------------------------------------------
  378. Manual, page 132, TextAngle Property:
  379.  
  380. This property has effect only if the vsPrinter uses a fully scalable (TrueType, PostScript) font.
  381.  
  382.  
  383. ================================================
  384. CORRECTED PROBLEMS                     30 Oct 97
  385. ================================================
  386. vsInForm
  387.   OnTop property ignored at runtime
  388.  
  389. vsPrinter
  390.   Action 1 does not print RTF text
  391.   vsPrinter 16 bits does not print header and footer
  392.   VB5 Controls placed in vsPrinter are not scrolled by the ViewPort
  393.  
  394. vsViewPort
  395.   ViewPort does not scroll a label
  396.  
  397. ================================================
  398. End of entries for this build          30 Oct 97
  399. ================================================
  400.  
  401. ================================================
  402. Initial release                        20 Oct 97
  403. ================================================
  404.  
  405. ================================================
  406. VSVIEW DataReporter (32 bits only)
  407. ================================================
  408. Now your users can dynamically generate data aware reports without writing a single line of code.
  409.  
  410. ================================================
  411. New Features
  412. ================================================
  413. Archive and ArchiveInfo methods: allows the programmer to add meta data (comments, document information, datafiles, ...) to report files. Greatly improved data compression over VSVIEW 2.0
  414.  
  415. Overlay graphics and text. Overlays is a new functionality of the vsPrinter control. It allows you to add or edit any page at any time, even after the report is created! For instance, with Overlays you can implement "Page 1 of X" functionality.
  416.  
  417. Full RTF Support in textboxes, tables, headers, and footers (32 bits only)
  418.  
  419. Enhanced zooming, scrolling, and panning
  420.  
  421. New Methods: ClientToPage x, y and PageToClient x, y
  422.  
  423. Multi-line headers and footers
  424.  
  425. Improved design time environment with preview guides
  426.  
  427. Picture property and Copy to Clipboard now create enhanced metafiles and include the overlays.
  428.  
  429. New printer settings - (PageCount, StartDoc file, etc.)
  430.  
  431. Save to PCL or PostScript
  432.  
  433. Enhanced tables - RTF support and adjustable table border thickness (TablePen, TablePenTB, TablePenLR)
  434.  
  435. Printer device selection may or may not alter the default printer setting for the entire Windows (DefaultDevice property)
  436.  
  437. IntelliMouse support for scrolling and zooming
  438.  
  439.  
  440. ================================================
  441. New Events, Properties, and Methods   
  442. ================================================
  443.  
  444. All events new to this initial release are fully documented.
  445.  
  446.  
  447. ================================================
  448. WARNINGS AND CAVEATS
  449. ================================================
  450. To use VSVIIEW3 under Windows NT4, you have to have Service Pack 2 or later installed.
  451. Correct function of VSVIEW3 under Windows NT4 without SP2 or later is not guaranteed.
  452.  
  453. VSVIEW3 depends of MFC42.DLL.  (Version 2 used MFC40.DLL.)
  454.  
  455.  
  456. ================================================
  457. DOCUMENTATION CHANGES                 
  458. ================================================
  459.  
  460. ------------------------------------------------
  461. None.
  462.  
  463.  
  464. ================================================
  465. CORRECTED PROBLEMS
  466. ================================================
  467. Not applicable for the initial release.
  468.  
  469.  
  470. ================================================
  471. WAIVERS                               
  472. ================================================
  473. VSVIEW3 16 bits (Vsview3-.OCX) does not have the Appearance property.
  474. Waiver:  This property is not available to 16 bit OCX controls.
  475.  
  476. TextAngle does not work with bitmapped fonts.
  477. Certain settings of Zoom may cause incorrect display of text printed in bitmapped fonts. 
  478. Waiver:  These properties work correctly only with PostScript and TrueType fonts.
  479.  
  480.  
  481. ================================================
  482. KNOWN PROBLEMS
  483. ================================================
  484. Custom form with InForm with CustomFrame changes both dimensions when resized in only one direction.
  485. Cause:          This is a Windows API problem.
  486. Circumvention:  Not available.
  487.  
  488. InForm's CustomFrame = True disables click-type controls (listbox, combo, filesystem controls).
  489. Cause:          This is a Windows API problem.
  490. Circumvention:  Place controls onto another container (picture, elastic).
  491.  
  492.  
  493. ================================================
  494. End of entries for this build          20 Oct 97
  495. ================================================
  496.